<!-- HTML header for doxygen 1.11.0-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.11.0"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Doxygen: Including tables</title>
<link rel="icon" href="doxygen.ico" type="image/x-icon" />
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/javascript" src="clipboard.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="cookie.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen_manual.css" rel="stylesheet" type="text/css"/>
<link href="extra.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectlogo"><a href="../index.html"><img alt="Logo" src="doxygen_logo.svg" height="35px"/></a></td>
  <td class="menu-item"><a href="index.html">Docs</a></td>
  <td class="menu-item"><a href="changelog.html">Changelog</a></td>
  <td class="menu-item"><a href="../helpers.html">Extensions</a></td>
  <td class="menu-item"><a href="../examples.html">Examples</a></td>
  <td class="menu-spacer">&#160;</td>
  <td class="menu-item" id="download">
      <img class="download-icon" src="../assets/download.svg" width="16px" height="16px" alt="Download doxygen"/>
      <a href="../download.html">Download</a>
  </td>
  <td class="menu-item" id="donate">
     <form action="https://www.paypal.com/cgi-bin/webscr" method="post" class="nav-item d-inline-flex px-1 mx-1">
       <input type="hidden" name="cmd" value="_donations" />
       <input type="hidden" value="doxygen@gmail.com" name="business" />
       <input type="hidden" name="bn" value="PP-DonationsBF:btn_donate_LG.gif:NonHosted" />
       <input type="hidden" name="lc" value="US" />
       <input type="hidden" name="tax" value="0" />
       <input type="hidden" name="item_name" value="Doxygen donation" />
       <input type="hidden" name="no_shipping" value="1" />
       <table class="donate">
         <tr>
           <td class="donate-button"><input type="image" width="74" height="21"
               src="https://www.paypal.com/en_GB/i/btn/btn_donate_SM.gif" border="0" name="submit"
               alt="Donate to Doxygen with PayPal!" /></td>
         </tr>
         <tr>
           <td class="currency"><select size="1" name="currency_code">
               <option selected="selected" value="EUR">&euro; (EUR)</option>
               <option value="USD">$ (USD)</option>
             </select></td>
         </tr>
       </table>
     </form>
   </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.11.0 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { codefold.init(0); });
/* @license-end */
</script>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
     <div id="nav-tree-ads-carbon">
       <script async type="text/javascript" src="https://cdn.carbonads.com/carbon.js?serve=CK7DTK3M&placement=stacknl" id="_carbonads_js"></script>
     </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function(){initNavTree('tables.html',''); initResizable(true); });
/* @license-end */
</script>
<div id="doc-content">
<div><div class="header">
  <div class="headertitle"><div class="title">Including tables</div></div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Doxygen supports two ways to put tables in the documentation.</p>
<p>The easiest is to use the Markdown format as shown in <a class="el" href="markdown.html#markdown_extra">Markdown Extensions</a> section <a class="el" href="markdown.html#md_tables">Tables</a>.</p>
<p>Although this format is easy to use and read, it is also rather limited. It supports only a simple grid of cells, while each cell is a single line of plain text.</p>
<p>For more complex tables the HTML syntax can be used. Doxygen will process such tables and translate them to the various output formats (at least for the formats that do support tables such as HTML and <img class="formulaInl" alt="{\LaTeX}" src="form_0.png" width="34" height="13"/> ).</p>
<p>Note a table should at least contain 1 row (<code>&lt;tr&gt;</code>) and in case a <code>&lt;caption&gt;</code> is used the <code>&lt;caption&gt;</code> should precede the first row.</p>
<p>Here is an example of a complex table:</p>
<pre class="fragment">&lt;table&gt;
&lt;caption id="multi_row"&gt;Complex table&lt;/caption&gt;
&lt;tr&gt;&lt;th&gt;Column 1                      &lt;th&gt;Column 2        &lt;th&gt;Column 3
&lt;tr&gt;&lt;td rowspan="2"&gt;cell row=1+2,col=1&lt;td&gt;cell row=1,col=2&lt;td&gt;cell row=1,col=3
&lt;tr&gt;&lt;td rowspan="2"&gt;cell row=2+3,col=2                    &lt;td&gt;cell row=2,col=3
&lt;tr&gt;&lt;td&gt;cell row=3,col=1                                  &lt;td rowspan="2"&gt;cell row=3+4,col=3
&lt;tr&gt;&lt;td colspan="2"&gt;cell row=4,col=1+2
&lt;tr&gt;&lt;td&gt;cell row=5,col=1              &lt;td colspan="2"&gt;cell row=5,col=2+3
&lt;tr&gt;&lt;td colspan="2" rowspan="2"&gt;cell row=6+7,col=1+2      &lt;td&gt;cell row=6,col=3
&lt;tr&gt;                                                      &lt;td&gt;cell row=7,col=3
&lt;tr&gt;&lt;td&gt;cell row=8,col=1              &lt;td&gt;cell row=8,col=2\n
  &lt;table&gt;
    &lt;tr&gt;&lt;td&gt;Inner cell row=1,col=1&lt;td&gt;Inner cell row=1,col=2
    &lt;tr&gt;&lt;td&gt;Inner cell row=2,col=1&lt;td&gt;Inner cell row=2,col=2
  &lt;/table&gt;
  &lt;td&gt;cell row=8,col=3
  &lt;ul&gt;
    &lt;li&gt;Item 1
    &lt;li&gt;Item 2
  &lt;/ul&gt;
&lt;/table&gt;
</pre><p>It has a caption, table heading, various row and column spans, a nested table as one of the cells, and a item list in another cell.</p>
<p>Note that the end tags (like <code>&lt;/td&gt;</code>) are left out in the example above. This is allowed, and in the HTML output doxygen will add the end tags again.</p>
<p> The output will look as follows:</p>
<a class="anchor" id="multi_row"></a>
<table class="doxtable">
<caption>Complex table</caption>
<tr>
<th>Column 1 </th><th>Column 2 </th><th>Column 3 </th></tr>
<tr>
<td rowspan="2">cell row=1+2,col=1</td><td>cell row=1,col=2</td><td>cell row=1,col=3 </td></tr>
<tr>
<td rowspan="2">cell row=2+3,col=2 </td><td>cell row=2,col=3 </td></tr>
<tr>
<td>cell row=3,col=1 </td><td rowspan="2">cell row=3+4,col=3 </td></tr>
<tr>
<td colspan="2">cell row=4,col=1+2 </td></tr>
<tr>
<td>cell row=5,col=1 </td><td colspan="2">cell row=5,col=2+3 </td></tr>
<tr>
<td colspan="2" rowspan="2">cell row=6+7,col=1+2 </td><td>cell row=6,col=3 </td></tr>
<tr>
<td>cell row=7,col=3 </td></tr>
<tr>
<td>cell row=8,col=1 </td><td>cell row=8,col=2<br  />
 <table class="doxtable">
<tr>
<td>Inner cell row=1,col=1</td><td>Inner cell row=1,col=2 </td></tr>
<tr>
<td>Inner cell row=2,col=1</td><td>Inner cell row=2,col=2 </td></tr>
</table>
</td><td>cell row=8,col=3 <ul>
<li>
Item 1 </li>
<li>
Item 2 </li>
</ul>
</td></tr>
</table>
<p>One can refer to the caption of the table using <a class="el" href="commands.html#cmdref">\ref</a> using the caption's id as the label.</p>
<p> 
Go to the <a href="diagrams.html">next</a> section or return to the
 <a href="index.html">index</a>.
 </p>
</div></div><!-- contents -->
</div><!-- PageDoc -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.11.0 </li>
  </ul>
</div>
</body>
</html>
